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Up where Applesoft lives 

Hiking Ixxyts and l^ackpacks, please. Fill your water txitUes. This month 
we're going on a trek to ttie high reaches of your Apple's memory There have 
Iseen some changes up where Applesoft and an expedition is in order. 

First lef s get our bearings. The machine language instructions that tell 
your Apple's microprocessor everything it knoMS al>out Applesoft appear in 
memory from byte $D000 (53248) to byte $f7lT (63487). The 10,240 bytes 
of code in this area first appeared in 1979, when the Apple Il-Plus was 
introduced. They remained untouched - totally unchanged — for five years. 
Then the Apple lie appeared in 1984 and suddenly there were differences. 
More changes showed up in the enhanced lie, which Apple introduced in 
March. 

On this month's outing we are going to take a close looli at these three 
versions of Applesoft and determine exactly what the differences are. It isn't 
necessary that you have your own maps of the territoiy— there is little doubt 
that we will return home safely— nonctheless/if you'd like to make some, 
here's hOM 

Basic map makiiigi lb make maps, you'll need to get momentaiy access 
to the IMO types of computers you don't ah-eady have. If you have a He, for 
example. you1i need to momentzdty borrow the neighbor's lie and the 
school's new enhanced lie. Boot the bonowed computer with standard DOS 
3.3. Don't use fVoDOS and don't useavcrsion of DOS 33 that moves itsclftD 
the upper reaches of memoiy Then simply take a snapshot of Dn Bask by 
BSAVEing the image of Applesoft in the bonowed machine. Mere's how: 

BSfiVE lie APPLESOFT IMAGE, flSO800, LS2B00 

The reason you don't want to boot with ProDOS (or a version trf DOS 33 
that moves itselO is that it will spoil your picture. Instead of Dr. Basic's gruff 
visage you'll get a smiling image of Uncle DOS. 

If you have a lie or an enhanced He and a DOS 3.3 System Master disk, you 
don't even have to borrow a ll-FIus or lie. The original image of Applesoft 
appears on the System Master disk in a file called FFBASIC (On old System 
Master disks, this file is 50 sectors long— it includes an image of ttie Monitor 
as well as Applesoft. On newer System Masters, it is 42 sectors long and 
includes only Applesoft ) 

Onoe you have your images, you make maps like this: 

(Load lmag6 at %2ZU.) 

(Enter Monitor,) 

(VerifL) that the first few bytes 

are identical.) 
(Turn an printer. } 
(Use the Monitor's Varify coramand 
tD get a list of the differences 
bBtwBen the inags at S20ee and 
the one built into your Apple.) 

Ifyou get a list of discrepancies from the first Verify command, you've done 
something wrong— don't print or you'll waste a ton of paper. Just start over. 

The second \ferify command will send a listing to your printer of the 
differences between the borrowed Applesoft image you have loaded at 
$2000 and ttie Applesoft image buUt into your machine. The listing will show 
you the address of each disoepanqr, the value at that byte in your built-in 
Af^lesofl and, in parentheses, the udue at that byte In the image loaded at 
$2000. Tor example, if you do this on a lie with the FPBASIC file from a 
System Master disk, your listing will begin like this: 



jBLORD lie APPLESOFT IMfi(5E, 

JCflLL -151 

KPRttl 

*2«00<O000.F7rrv 



2000<D000.F7FFV 

O034-F4 (74) 
D03S-03 (F7) 
D04E-F4 (BB) 
D04F-03 [F3) 

The listing will go on for several pages. There are 384 bytes of differences 
(6 printed pages) between f PBASIC and lie Basiq 326 bytes of differences (6 
pages) between the enhanced He and the He versions; and 179 bytes of 
differaices (3 p^es) between the enhanced He version and the original 
FPBASiC As a percentage, the differences between the three versions are 
quite minor-at most less than4pcr cent of the original Applesoft image is 
dianged. 

Ampersand vall^. As we begin our little amble, the first features we eome 
upon are those between $D034 and $D06F, as shown above, (in assembly 
language language, we say those addresses are on "page" $D0. In this way of 
looking at things, the Apple If has 256 pages of memory. $00 through $rF, 
and each page holds 256 bytes. The first two hexadecimal digits of an 
address point to the page, the last two to the byte.) This particular area of 
Applesoft is a table of addresses. The addresses point to the machine 
language routines that actually execute the various Applesoft commands. 




At the very back of Saveload Cave there is ftome strange new code. 

The changes here affect the commancte SHLOAD, RECALU STORE, LOAD, 
and SAVE. The thing these commands have in common are that they are all 
cassette tape commands. You are probably more femiliar with LOAD, SAVE, 
and Basicsystem's STORE as DOS commands. When you put a filename 
after these commands. Uncle DOS recognizes and executes them. If you 
leave off the filename, Uncle DOS passes the command on to Dr. Basic who 
starts fiddting with the cassette tape jacks. 

Since no one in their right mind uses cassette tape for storage anymore, 
these commands are pretty useless. Worse than useless, really, because 
when you execute them by mistake (by forgetting to put a filename after a 
DOS command), your Apple will appear to hang It's not really hung, of 
course (Dr. Basic is purposefully fiddling), but it might as well be ^ce you 
have to press Reset to recover. 

The He doesn't have cassette tape jacks, so the code that executes these 
commands was removed from the He. As we'll see later, the space was used 
for something else. However, though the code that executes the commands 
was removed, the commands themselves are still there. The changes on 
page $D0 point all five of them to the execution address of the ampersand 
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(&:} command. This gives assembly language programmers the possibility of 
easily implementing six ampersand commands on the lie (To discern 
t)etween the six, an ampersand routine can refer to bytes $B8-$B9; they point 
one byte beyond the token of the command that caused the ampersand 
routine to be executed The tokens you Mdll find are: 

A token table (for asfieoisiy languiga pnigramers only} 



SHLQflD 

RECALL ift? 
STORE $fl8 



LOAD $BG 
SfiVE te? 
& iflF ] 



The enhanoed lie Gontinues to support cassette tape, so there are no 
changes in th^aiea in an enhanced lle'sApplesoft 

Lowerose CrcA The next discrepandes are on pages $D5, $D6, and 
$D7. Scattered through this area are 21 bytes of differences. This part of 
Applesoft contains the routines that parse (tiy to make sense of) your 
commands. Also here are the routines that create program listings in 
response to the LIST command Most of the changes in this area consist of 
hooks inserted into the command parser that cause new sections of code, 
stored elsewhere, to be executed during the parsing process. This new code 
allows lower-case input 

The changes are pretty intelligent If you enter programs in lower case on a 
He or an enhanced He, you'll find when you LIST the program that com- 
mands and variable names have been converted to upper case. However, 
stuff inside quotation maifcs, REN statonoits. and DmstaAments wOl not 
be. For example: 

119 print "Qpcn-flpple \/:'';v;" N:";n ; data June 1985 : rem issue datg 
]Ust 

10 PRINT -Opan-fipple V:'';Vr Nr;N : DflTfl June 1985 : REM issue date 

This sample also illustrates the effect of the other changes in this area, but 
they are more subtle. One of the patches causes program listings to begin 
with a blank spacCi Him makes "escape mode editing' much easier, since it 
is no kmger nec£ssaiy to back^iac^ ow the line number. (Escape mode 
edHfa^involm pressing tlie escape k^folkM^ 
letters in the l-J-Mi diamond, to move fiie cursor to the beginning of the 
Basic line you want to edit pressing the space bar, and then using the r^t 
arrow to reenter the line.) 

The final change allows Bask program ilstingis to be 80 columns wide 
when the Apple 80cotumn mode is turned on. 

Saveload Cave. The next changes occur on pages $D8 and $D9. In the 
original Applesoft, this area contained the routines that executed the 
cassette SAVE and LOAD commands. On the enhanced lie this area is 
unchanged. On the lie however, the cassette routines have been removed. In 
their place are the routines that perform lowercase and LIST conversions. 
The hooks we looked at earlier on pages $D5 through $D7 all point here on a 
lie 

At the very back of Saveload Cave, from $D8DD to $D91l there is some 
strange new code. It looks kind of scary, so let's move right along. . . . 

CoDunatab Ridge. Proceeding onward, we next come to a series of 
changes on pages $DA and $DB^ This area of Applesoft has the code that 
executes PRinT statements. 

Under the PRIPiT umbrella are three functions for formatting output that 
lob of people forget about They are TAB(< SFC(. and comma tabbing. Hot be 
ooitfiised HlAfi and VIAB, these functtons can only be used uMhti a 
PRUtr statement 

The changes in thisareaof^iplesoftfixthesefundionssotheyi^ 
8(Hx»Iumn screen. On an SOcolumn lie or enhanced He, eadi of the 
following lines does the same thing: 

im PRINT "THI5". "IS", "ft", "TC5T." 

lie PRINT -THIS"! SPC(12J; "15"; SPC{i4]; "ft"; SPC(15); "TEST." 

120 PRIKT 'THIS-, TflB(17J: "IS-. rflfit33}; "ft-; TWBt^gj; 'TEST." 

THIS 15 fl TEST. 

THIS IS fl TEST. 

THIS IS R TEST. 

Comma ta^Nng means u^GonfuiaSbiallKrthanteusu^ semicolons, 
between items in a PRIPiT statement The items wffl lie pffnted beginning in 
columns 1 17, 33, 49, and 65, as long as each item is less than 16 characters 
long. Longer items cause columns to be skipped: 

m mm 'this is tkt mo-,2 

ne Pf?INT -THIS IS TEST MO.",? 



THIS IS TEST NO 2 

THIS IS TEST NO. 2 

The SFC( function prints the specified number of spaces, note that the 
value inside the parentheses can be a variable or a formula as well as a 
number. The TAB( function is similar, but it moves the output position to a 
specified position on the output line. 

Double-Low Forest We are now approaching the most mysterious part 
of our expedition. There are a number of changes upcoming In the lie 
version of ^plesofl that, to the best of my knowledge, have never been 
documented anywhere. liot by Apple itself, not by other writers* first though, 
dimb up this small hill here and look ahead to byte $E006. 

The semi at $£000 to $E006 contain the startup addresses Itx 
Basic and an identfficatidn byte. A call to 57544 (te^ 
(this erasesany program in memory).Acall to 57347 ($E003)imnslartsit 
At 57550 ($E006) there is a version identidcation byte tNt is never executed 
or otherwise used for anything its contents are: 

Contents of byte 57350 (SESeS) 



II-Plus and origlntl He 

He 

enhanced lie 



t«W) 
13? (189) 

196 ($C4) 



Plow just in front of us, at bytes $DF03 and $DF04, is a change that causes 
the He's SCRTI function to execute some new code stored elsewhere. SCRT! is 
one of Applesoft's low-resolution graphic functions— it returns the saeen 
color at a specified coordinate. Up ahead, on pages $FX $f^, and $F3, are a 
number of other changes, in the lie version only, that point to new code. 
These pages hold the code that executes the low-res QR, PLOT, HLin, and 
VLin commands. Have you ever heard anything sfrange and wonderful about 
the He's low-resolution graphics commands? i^s study these things more 
closely on our return trip. 

StorerecaU Cave. Forging ahead, we next come to Storerecall Cave, also 
in page $f 5. This is where the cassette tape commands STORE and BEICML 
Uk in Hie original and enhanced He versions olApplesdt In the ilc m^km, 
howevef; well poke your head in —youll see that tfris is where someone has 
stored all the new code that the low-res commands now use. 

Shioadhtab Cave, The final area of diiferences is on page $F7. The first 
part of this area is home to the cassette command SHLOAD in the original 
ll-Plus Applesoft. The last 25 bytes or so belong to HTAB. 

What can l>e confusing is that there are three "caves" in the ilc version of 
Applesoft, all formed by removing the code that executes cassette tape 
commands— but there is only one cave on the enhanced lie. You may 
wonder how even this cave was hollowed out since the enhanced He still 
supports the SHLOAD command. 

A close examination of the machine language code at $F775-F786 reveals 
that SHLOAD was pushed down a rabbit hole. It now lives below ground in the 
area where the original He had diagnostic routines (invoked by pressing 
solid apple/control/reset). The enhanced He still do^ diagnostics, but not 
as many as the original He« 

Th^ rabbit hole is an underground msion of pages $C1 through the 
area mtoe the flnmuare on peripheral cards noimal^ appears. SHLOAD 
itsdf now starts at SC500. lb access this am, you have to throw the 
"SLOTCXRON" sdbwitehes. A poke to $C007 (49159) lets you see the 
underground RON in this address range, a poke to $C006 (49158) lets you 
seeu^ts on peripheral cards. (By the way. T^bte 6-5 in Apple's He reference 
manual, page 135, has these softSMitches backMards. ) 

Come badi to the main level now and walk all the way back to the end of 
this cave. Here, at the veiy top of Ai^esoU we find some changes to the 
HTAB command The changes make HTAB mk conrect^ in 8&€0lumn 
mode. 

An extremely Interesting feature of the HTAB modifications is right at the 
end of Applesoft -byte $r7FE. On the lie this byte holds the code for the 
assembly language command "branch always." This is one of the new 
commands only available on the 65C02 miaoprocessor— the eariier 6502 
doesn't support it Of course, the 65C02 is built into the He, thus you would 
expect It to use some of the new commands. The strange part Is that on the 
enhanced He, this byte holds the command for "branch on not equal," which 
also happens to work here. But this is an old instruction— available in the 
standard 6502 command set—even thoi^ the enhaiced lie also has the 
newer 65C02. 

Thinking back, however, you'll be hardpressed to remember seeing any of 
the new 65C02 commands in enhanced He Applesoft. Thaf s because there 
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aren't anjt I've been told there aren't any in the rest of the enhanced He 
firmware^ either, though I haven't checked that out myself. If Apple doesn't 
use the new 65C02 commands in the software that s^built into the machine, 
who do you suppose wfU use them? 

Let's go t>ack now to the front of this cave. With SHLQAD out of the way- 
simply gone on the lie and down the rabtiit hole on the enhanced He —we 
find the cave filled with different ^ings depending on which computer we're 
looldng at The enhanced lie has all Uie tower-case and LIST patches in this 
cave. On the He we found these earlier, in Saveload Cave. 

The Double-Low-Res ^»ectacular. On the He this area contains still 
more changes to the low-res graphics commands. To find out what these 
changes are all about lets return to the Double-Low Forest and Storerecall 
Cave, Avery interesting little routine lies at $F3CB on the He It is called from 
several different places in the new code. This routine reads an undocu- 
mented Softswitch at $C079, as well as soflswitches that indicate whether the 
8(Hx)lumn screen is l>eing used. 

A little experimentation with the unknown Softswitch at $C079 shows that 
it indicates \*1iether the lie's double-resolution graphics have been turned 
on (high bit set single-resolution; clear, double-resolution). According the 
lie reference manual's Table 5-8, Uie Softswitch for this is supposed to be at 
$C07F, not $C079; both addresses seem to work, however — on (he^pple ffc 
On lies, both original and enhanced, these soflsMtches don't exist 

The routine we have under the microscope, the one at $F5CB, returns with 
the C£my set if both double-resolution and an 8(kx)]umn screen display are 
himed otu the cany is cleared otheiwise. By looking at the routines that call 
this oner we can asoertedn that Ihey appear to allaw the kniHresolution 
graphk:s commands to work in an 80 by 48 mode if double-resolution 
graphics are himed on. But there is no buUt-in command to invoke this new 



mode. 




If you have a He tiy this series of commands: 


PRtt3 


(turn on the 60-COlumn screen) 


PDKE 4924G.e 


(turn on dauble-resaiution graphics) 


GR 


(start-up iou-res graphics) 


CDLDRs3 


(set color ta somBthing qther thtn black) 


PLOT 51.10 


{place a gixel at column 50, line 10) 




(capture color at 59,10 in X) 


HLIN e,79 AT 20 


(draw a line across the screen) 


VLIN 0.39 AT 40 


(draw a line doun the screen) 



Mow how do you like that? Here's a completeiy new graphics mode, 
coMiplete mUiAppi^oft support, and Apple's manuals don't breame a 
uxmfahoutlt 

Since its probably been awhile since most of you worked with low- 
lesolution graphics eomn^ds, here are some tips for experimenting with 
this new mode First don't forget to set the color to sometliing. If you 

forget to use the COLOR command, your PLOTs and UHs wiO be inviMble. 
You'll insist there isn'tany such thingas doiJd)le4oW'resolutk)ngrs4>Mcs,b{xt 
there is. Second, bewKofputtingaiiEat the end oflliemiNaiidl^ 
Gommands. If you do, Applesoft thinks the E is a variable and draws all lines 
beginning at v^^iatever value E is (usually zero). 

The primary advantage of double-low-resolution graphics, compared to 
the high-resolution graphics that Applesoft also supports, is that double-low 
supports sixteen complete colors rather than the six sort-of available in hi- 
res. Of course, double-high graphics can also do 16 colors (at 140 by 192 
resolution), but Applesoft can't help you with that— it has no double-high- 
resolution commands. 

A Double-Low Bug. The spectacular, hidden double-low-resolution 
graphics routines in the Apple lie even have a spectacular, hidden bug. Since, 
in our graphic tiy-out eariier we said C0L0R=3, and since we did a PLOT 
504^0, the X=SCRri(50aO) command should have set X to 3. But now enter 
PRirrr X YouII find it equals ITlty this: 

10 «»« SGRN Tester 

im 6R 

110 CDLOR-S 

120 HLIN e,2e NT 10 

130 FOR 1=0 TO Z0 : PRINT SCRN(i;i0rr *; : NEXT 

When you mn th^ progi^Jt#^youa sai^offoursandfi^ 
give you a sarles fives wittKHitfows. The SCRTi command doesn't work 
right in double-lowiresolution. The reason is pret^ oomplfcated. It beg^ 
with the fact that double-low-resolution color bytes that are ^red In the 
auxiliary display page have to be rolled one bit to the right to compensate for 
some shortcomings in the Apple's color abilities. The new SCRR code has to 



take this into account when fetching values from the auxiliaty page, and it 
does. ExG^ that it shifts Idt when it should roU left (this is assembly 
lai^uage talk, for those of you who are puzzled by this paragraph). Conse- 
quently, SCRlliAi^ gets odd-numbered co1(hs wrong when they 
in the awdliaiy display page. 

Since we've gone this far, we might as well fix it don't you think? 'fty this 
little program: 

10 REM ♦«« Applesoft Tung-up «*« 

100 TEXT : HOME : VTAB 12 ; PRINT "Just a minute here..." : PRINT 

110 X=PEEK(192B1) : X=PEE:K( 43201) : REM read from $O000-$FFrr ROM, urite to RftM 

120 FOR P=20S TD 255 

130 : PRINT "Working on page 

140 : FOR B=0 TO 255 

1S0 : : I=B+(P*256) 

160 : : POKE LPEEKfl) 

170 : NEXT 

1B0 NEXT 

ige X=PEEK( 49283) : X=PEEK[ 49283) : REM read (WM (suitchaa to RfiM Applesoft) 
200 POKE 63415,42 : REM change ftSL to ROL 

This program works by loading a copy of Applesoft into the "language 
card" area of memory. This area RAN shares the address range normally 
used by Applesoft and the Monitor. The sdbwitches that control this 
memory allow reading and writing to be activated independently. 

APPLESOFT TUnE>UP takes advantage of this in lines 120 to 180. At first 
these lines may make no sense at all. What they're doing is copying Applesoft 
and the Monitor from their normal home in ROM to the equivalent address 
range in FWl. Line 190 then turns on the new RAM version of Applesoft, and 
line 200 modifies it to fix the problem with the SCRTI command. 

How try SCRTi TESTER again. 

Home again, home again, Jiggidy jig. As we return from our expedition 
to the high reaches of Apple memory, consider the things inside Applesoft 
that Apple's wizards didn't change. While Applesoft is a pret^ solid language, 
it ek)es have some bugs in it The suiprise is that none of them, not even the 
easyones^werefixed 

For example, there is a weikkicumented Inig at $D970 that causes a 
KETUrai WrniOUT QOSUB enor when there isn't one (see ? ^plesoft 
Error, by Cornells Bongers, in Call AEELE. in Depth H:MAbmit Apple- 
Sf^ ps^ 100). On the one hand, I can understand Apple's reluctance to 
make more changes inside Applesoft — compatibility problems could arise. 
On the otiio* hand, however, the bug at $D970could be fixed by changing the 
value of one byte, I don't think that would cause many compatibility prob- 
lems. There are several other changes like this tiiat could have been made. 

But now that we have our own private version of Applesoft in RAM, what 
Apple did or didn't do doesn't make much difference. We can fix this bug and 
make any other changes we like as well. How about adding a DLQR (double- 
low graphics) command that does a POKE 49246,0 and a GR automatically? 
Add these lines to the end of the APPLESOFT TUNE-UP program: 

210 C$="DS70:9G" : REM fix RETURN WITHOUT G05UB problem 

215 GQSUB 500 

220 Ci="O012:35 FB" : RLM adr uble position of TEXT, use Monitor to make space 
225 603UB Sm 

230 C$="D0GC:9a F3" : REM adr table position of LQflO, use for DLGR 
235 GDSUB 500 

240 CJ="D1BC:4^ 4C 47 02" : REM change 'LDflC to 'DLGR' in cmd name table 
245 GOSUB 500 

250 Cl-'-DggEiflD S3 C0 60" : REM GR and DLGR patches 
255 G0SU6 500 

2G0 C$="F390:flD SF C0 flO 5G C0 4C EC 08 flD SE C0 4C 33 f3" 
265 GQSUB 500 

280 PRINT CHR$(4)rB5flVE FPHPSIC IIC.l, flJO0«0, 153000" 
250 END 

500 Ct=C$+" N DSCGG" : REM 5-H. Lam routine 

510 FOR 1=1 TO LEN (C$) : POKE 511+1, fiSC(l1I0«[GS,1 ,1) )+12B : NEXT 
520 POKE 72,0 : CfiLL -144 : RETURN 

Mtjsr running the complete APPLESOFT TUn&UP, youll be able to switch 
between douWe-towiresolution graphics and regular lotaKesolution with the 
Gommands DLQRand QH I/you have the 8(kx>lunm screen active. (I tried to 
make DLQR turn on the 80<x)lumn screen, too, but DOS gets disconnected if 
you do It the easy way. To tell DOS whatyou're ddng takes more space than Is 
readily available — this is no doubt why the equiralent of DLQR vrasn't built 
into lie Applesoft.) 
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The program will also save an image of the modified Applesoft and the 
Monitor in a file called FPBASIC 1IC.1 The purpose of this file is to speed up 
reloading this new version of Applesoft (APPLESOFT TUliEi-UP itself takes 
over two-and-a-half minutes to execute). Here's how it works: 

10 REN *** Load My Basic *** 

100 TEXT : HOME : VTRB 12 : PRINT "Just a minute here..." : PRINT 

110 X=PEE1<( 43281) : X=PEEt<( 49281) : REM read RDM, write RAM 
120 PRINT CHRf (4};"BLaRD FPSftSlC IIC.l" 
190 X3PEEI<(492B0) : REM read RAM 

?iow suppose you ran LOAD MY BASIC on a He or Il-Plus. Could you use the 
lie version of Applesoft to add doub!e-low-res Basic commands to an older 
machine? Since the Il-Plus doesn't support double-resolution^ it's out imme- 
diately A lie would need a 65C02 microprocessor to execute He Applesoft, so 
an enhanced lie is a possibility. But it doesn't work. The problem is our old 
friend $C079. This is the byte that indicates whether double-resolution 
graphics are active on a lie On a He it flips back and forth pretty much at 
random. 

nonetheless, the fec/iniques we've looked at here can be used on a He or a 
64K Il-Plus to make special versions of Applesoft. Just remember you have 
to use an unrelocated version of DOS 3.3 to do these tricks. ProDOS uses the 
language card for its own purposes, so with it there's no room for your 
personal version of Applesoft 

If this sounds interesting to you, I suggest you contract S-C Software (RO. 
Box 280300, Dallas, Texas 75228; 214-324-2050) and get their program 
called S-C Documentor ($50). Using the Applesoft ROMS in your computer, 
this program creates a complete, well-commented, source code listing of 
Applesoft. The code is put into files formatted for the S-C Macro Assembler. 
Modifications are much easier when you don't have to disassemble every 
line of code yourself. This article, for example, would have been unimagin- 
able without the Documentor's help. 

A CP/M Primer 

by Jim Whitehead 

Editor's note: / would like to write everything in Open-Apple myself, but 
there are some things I just don't have time to investigate. When I fmd 
something thaVs really good in one of these areas, I'll try to publish it for 
you. CP/M is an example of something I don't know much about but lots of 
Apple users are interested in it The following is the first article I've ever seen 
on CP/M that doesn't use the word "BIOS," It is reprinted, with permission, 
from the March 1985 issue of PfEAT notes, the newsletter of Hew England 
Apple Ttee (RO. Box251B, mbum, Mass. 018881 

At last month's FiEAT meeting, there was an emphasis on CP/M. However, 
since CP/M is by no means easy to learn, there may be many club members 
who are totally in the dark about what went on, or who don't know how to use 
the stuflfthey picked up at the meeting. Therefore, here is a CP/M tutorial. 

CP/M is an operating system, such as DOS 3.3 or ProDOS, However, CP/M is 
different DOS 3.3 and ProDOS were primarily designed to take advantage of 
Applesoft, which is built into the Apple. CP/M, on the other hand, was 
designed to be independent of any particular language. Thus, while DOS 3.3 
and ProDOS contain special features for the sake of Applesoft, CP/M is only 
concerned with operating the hardware of your system— the disk drives, 
printer, modem, and other peripherals. The ftill name for CP/M indicates the 
limits of its functions— Control Program for Microprocessors. 

CP/M is software— a program— just as DOS 3.3 is software. This often 
conftises Apple owners because they have to buy a piece of hardware— a 
"CP/M board" - to use it The reason for this is that CP/M is written in 8080 
machine language, not the 6502 machine language native to the Apple II. To 
run 8080 programs, you need an 8080 (or a more advanced Z-80) micropro- 
cessor. Most CP/M boards give your Apple a Z-80 microprocessor on a plug- 
in card. What the card does is allow its onboard Z-80 microprocessor to 
converse with the Apple's I/O slots and memory while executing CP/M. Some 
boards contain their own memory in addition to other built-in ftinctions, but 
their purpose is basically the same— to allow CP/M programs to run on an 
Apple II computer. 

Why should you want to run CP/M applications? Because much of the best 
software available for microcomputers, particularly for business applica- 
tions, executes only on CP/M machines. WordStar cannot be run on a 6502, 
nor is dBase II available for un-CP/M'ed Apples. Microsoft's Multipian even 
works correctly with your Videx 80-column card when running under CP/M. 



(Under DOS 3.3, the screen is shifted to the left about 1/2 inch, and is veiy 
annoying to work with.) This brings up another highlight of CP/M. If you have 
an 8()-column card, you seldom need to worry v^iether it will work with CP/M 
software. In fact unlike DOS 3.3, under CP/M it's the 40-column users who 
are discriminated against— a satisfying feeling for those of us who have 
plunked down good money for an 80-column card just to be left stranded by 
most programs. For these and other good reasons, CP/M is well worth 
purchasing. 

However, like most computer products that actually do the neat things 
they're supposed to do, CP/M can't be fully utilized without plowing through 
long manuals M\ of computerese and double-talk. This tutorial will attempt 
to convey basic mental attitudes needed for using CP/M. If you start thinking 
the CP/M way learning new programs and utilities becomes a snap. However, 
CP/M does things in a manner that differs greatly from DOS 3,3, so you'll 
need to throw out all of your preconceptions of how an operating system 
should be. 

The first radical change between DOS 3.3 and CP/M is the way disk drives 
are named. Say goodbye to drive 1 and drive 2, all drives are letters now. Old 
drive 1 becomes drive A: (the colon is very important) and drive 2 becomes 
drive B:, etc Plus, since there are no slots in CP/M, a third disk drive in slot 5 
(a DOS 3.3 Slot 5, Drive 1) would be called drive C:. 

The next difference between DOS 3.3 and CP/M is the hardest one to take. 
CP/M limits filename lengths to only eight characters. This often necessi- 
tates the creation of mnemonic file names, such as PADDPROQ instead of 
PADDLE PROGRAM. This also brings up one major problem with CP/M — after 
a month or so. who can remember what the mnemonics RTATR4 or LIPSTR 
stand for? 

CP/M does have one other part to its filenames, however, called the 
extension. This is a three letter suffix tacked onto the main filename with the 
glue of a dot (.). File extensions are supposed to give some idea of what is in 
the file. For example, text files from a word processor should have an 
extension of .TXT, standing for text Basic files automatically have a .BAS 
added to them, and other applications usually have their own specific 
extensions, The filename extension is the only means within CP/M of 
differentiating between separate file types. 

A full filename in CP/M has all of the elements just discussed, exactly in the 
following order: 

{drive}{ filename [.{extension} 

In CP/M, the drive being referred to is placed before the filename, instead 
of after it There is no "A" syntax in CP/M like the ",D1" syntax in DOS 3.3, On 
occasion, the beginning drive name can be omitted, thus automatically 
referring to the default drive. Which one is the default drive? If you haven't 
figured it out by now, the CP/M prompt is significant Upon booting up with 
CP/M, the prompt is a "A>". The "A" indicates the default drive, and the ">" is 
for decoration. To change the default drive, type a "B:" (or any other valid 
drive) at the CF/M prompt (Make sure a disk is in the drive!) The default drive 
is assumed every time you omit a drive specification in a filename. Therefore, 
if CP/M mysteriously can't find a file you know is there, check the disk drive 
specified and make sure it wasn't omitted. 

Once the format for filenames is understood, the next most important 
difference between DOS 3.3 and CP/M is the ' In DOS 3.3, the is often 
used as a wildcard character, allowing any text to be automatically substi- 
tuted in its place. In CP/M, the "*" is the wildcard character and "=" is used in 
another way It designates what file is to be acted upon and what file is to be 
used in an action. As in the Basic statement >l=4+X in CP/M the ' does not 
indicate an equality, but tells the computer to "make these things equal" 
Following this definition, the "= " is interpreted as: make the first thing equal 
to the second thing. The "things" are usually filenames. 

In PIP, the FID of CP/M, the equality is straight The second "thing", a file on 
a disk, is copied into the first "thing", thus making them "equal". In APDOS, 
the DOS 3.3 to CP/M conversion program that comes with the Microsoft 
Softcard, a sfraight equality is again made. The exception is that the first 
"thing" is a CP/M file and it is made "equal" to the second "thing " by means 
of a file conversion. Thus, while the "=" is used in both PIP and APDOS to 
make an equality between files, what the programs are actually doing varies 
greatiy 

flow let's look at some of the other frequently used CP/M commands. 
Instead of CATALOG, CP/M has a DIR(ectory) command. This command is 
entered in the form: 

DIR {drive}{f ilename} 

Typing DIR will catalog the default drive, typing DIR B: will catalog drive B:, 
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etc Ijyping DIR follomed tsy a filename acts Uke the veri^ command under 
FroDOS, simply demonstrating that a file exists. 
Other useful commands arecaDed using the fiinilak 

{coMiand} {filenans to act on} 

These Gommands are: 

TYPC-disj^s^ the contents of a .TXT or ftlfc (Or a file with any 
extension, if it contains text) 

STAT-di^)lays how much space a fDe uses on a disk, mum called like 
DIK (i.e. STAT &) it will dis|^ only howimidi^aoe is lefton the designated 
disk. This command also has many otha' functions, consult a manual for 
more details. 

ERA— Erases the filename specified. TVpc ERA V to completely erase a 
disk of all files. In this example, the asterisks are wildcards and the default 
drivels scrubbed. 

As mentioned earlier, one program that is essential to using CPM is called 
PIP {Peripheral Interchange Program). This program copies files from one 
disk to another. It also has the ability to transfer files to the various devices 
connected to your computer. Using PIP, a .TXT file can be transferred to a 
printer or to a modem. For bare copying functions, use this program with the 
like this: 

PIP (neufileH°ldfllB} 

This command gets PIP to copy oldflle onto ncwfilc.just as our knowledge 
of the "=" would indicate. 

Another command that is used with the is REH. RHI Is eqidvalent to 
DOS 3.3's REMAME command, but it is called in a different feshion. With DOS 
3.3, to change the name of a file you enter REIWIE {oldname},{ncwnamel, 
and the file is renamed. To do the same thing under CP/M, you must enter 
REN {newname!={oldname). 

There are many other commands available to CP/M. CP/M is limited only 
by the machine it is running on. All CP/M files ending in '.COM" are 
commands. Hence, though syntactically PIP and REN are summoned the 
same way they are different because PIP is a ".COM" file while REN is an 
intrinsic command of CP/M. This is a powerful idea, for it allows a multitude 
of commands to be added to and deleted from the CP/M vocabulary at wilL 
with only those oimmamls that are neo 
space. 

The full power of this "nothing but the bare necessities" idea is evident in 
Microsoft's MBASIC This version of Basic is much more complex than 
i^^esoft smd is a real Joy to program in. Yet all of this extra power is 
accomplished in less space than vAiat Applesoft and DOS 3^ take up. Disk 
commands aie a part of MBASiC anowing easy programming with no 
conirohD's and no macMne language oveihead devoted to inlieipreting 
oontroWs. 

For those of you who m lafiimiliar with MBASIC yet who want to run 
MBASIC programs, here is a ^ort explanation of how to get these programs 
operating. 

It is somewhat more difficult to start a Basic program under CP/M than 
under DOS 3.3 and ProDOS. This is because you have to start up MBASIC by 
hand, where Applesoft starts up automatically To get an MBASIC program 
running, you first have to boot CP/M. Then startup MBASIC. It's in a .COM file, 
so just type "MBASIC" at the CP/M prompt After loading, MA5IC will give a 
welcome message and then print OK. Once you see th is OK, you may place a 
disk with programs on it in the other drive, drive B:, Then type 

LOflO *B:{pragraa mam]" 

There is no need to add the .BAS extension, as it will be done automatically, 
but the quotation marks are essential. After the program is loaded, type 
"RUN" to start it Use ControK to exftaprogiamatanytiRie.'Qrpe "SYSTOT 
to get back to the CP/M prompt 

If you don't have two disk drives, the procedure is more complicated. First 
you have to create a blank system disk. Then use PIP to copy both MBASIC- 
.COM and the program you want to execute onto this disk. 

Another thing that often conftjses t>eginners is that wtiile DIR is the 
command for cataloging a disk from the CP/M prompt Inside MBASIC you 
have to use another command. It goes like this: 

FILES "B:* 

Once again, the quotation marks are essential. 

That wraps up this CP/M tutorial. Be aware that we have only saatched the 
surface of CP/M here. Use this as a beginning. Consult at least two CP/M 
books on points you are unfamiliar with, TWo viewpoints often fill in what 
each othor missed. Ctood lucK aiKl happy CF/MingI 
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The current version of AppleWoiks is 12. If you have an older version, 
backup your disks and take the originals to your dealer and ask to have them 
updated Version 12 includes a way to modify printer inter£EK£ card setup 
strings and supports Apple's Scribe printer. Other changes are mtoor. Here 
are some setup strings to try for various interface cards; 

Printer interface card setup strings for flppleUorks 

Tymac/Hlcrotek control-I 99 H 

Apple's Gun cards controi-i 8% N 
GrapplBr/PUaso control -I N 

Practical Peripherals controi-l N 

Apple surveyed software developers last August and the results, 
though a little old already, are interesting. Apple sent its survey to 3,200 
certified Apple 11 developers and 970—30 per cent— responded. At the 
time, more respondents said they were developing software for the Apple II- 
Plus than for die Apple lie Over half the respondents said they were still 
developing lI-Plus software and more than a third said th^ planned to 
continue doing so. 

Three times as many developers were using DOS 3.3 as either Pascal or 
ProDOS. Basic was the development language used by most people, though 
with first and seccmd choices added togethei; assembly langi^ nud^ 
into first place. 

The most desired new features for the Apple II were larger floppies (29 per 
cent), a faster miaoproccssor (19 per cent), and more RAM (10 per cent). 
"Please indicate your feelings concerning 3-1/2 inch disk technology. Issues: 
morecapad^noDOS3^suppoit newdiskmediacompatibility:" strongly 
in 6m 48 per cant; neutnd, 52 per cent^ strongly opposed. 5 per cent 

Software l9a€hea|iBusfnes8li(>0etlnto--hutNiii^I^v^ 
of a recent ¥Ml ^miJoumMmMe (April 29, 21). The artide gave the 
results of yet another software develops surv^- this one dime by 
sofs at the Geoigla bisffiule of Technology People who start softmaie 
amipanies are likdy to be male^ wdl educ^ed, and optimistic the auivcy 
found. Most companies are started with a modest capital investment'- more 
than half the 193 respondents to this survey started wfth less than $10,000. 
The researchers conclude that developing software for microcomputers is a 
"classic cottage industry." 

The artide also quotes Bernard Goldstein, a partner in a firm that special- 
izes in software company mergers. Creating a new software product can't 
always be accomplished with lots of money and people, Goldstein says. The 
ability to create new software is often lost at established fimis, he contends, 
because die talent tiiat can do that has left or is occupied maintaining and 
improving existing software. Often new products are developed by people 
working in their spare time or in obscure businesses. Creating a software 
product is like writing a book, Goldstein suggests. "If you consider what the 
author of a book receives if he is successful and what the successful software 
author recedes, I think the odds are better for tiie software author. " 

I agree with Goldstein. I would add that although stories abound of 13year 
olds who make a $100,000 a year selling software, precious few adult Apple II 
softMare developers do anywhere near that well. However, you can make a 
aMtotable Ihing at software development if you understand the impor- 
tance amf cost 0/ markeUng and you don't get greec^ WHting books, as 
Ooldslefai 8u^esl& isapurak best left to the Indepeiid^^ 

ilibbleniagazBier loi^a proffigaleuaer of ui^i^^ 
priniarityres^mlblefortheshaf^ofei^^ 
the publishing indu^ F^IMM a new rea»d for ccmiputer magazines in 
Nay when ft u^ four (countfem— fourl) exdantation points on its cover. 
FlaSny mcHre weie used faidde. PubUshbig indusby Gfpats say it may be 
months before exdamalion poiirt manubdufcra aie Me to rebuild 
supplies. 

In liemoriam: ^ccess;AppJe,Tlme-Life's newsletter for business uscrsof 
Apple computers, died with the May issue. Let us also momentarily bow our 
heads for IBM's dreaded Apple ll-killer, the PC >. It really was a peanut after 
alL 
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The customer is always right 

Did you notice? Yes, the type is bigger in the front 
section of this newsleUer, That's because lots of 
paying customers said they couldn't read our old 
type and because some wag rei^ewing Open-A^ie 
said the type was smaller than Epson's ultra- 
condensed. I couldn't tatce it anymore. 

Really quite expensive 

Potential subscribers to Open-Apple, BEWAf^E! My 
subscription has cost me $1247.00. Because of arti- 
cles in this crazy newsletter 1 have purchased a Sider 
hard drive and Applied Engineering's RAMWORKS 
withRQB. 

I have a He and a Il-Plua I took the f l-Plus to work to 
prevent computer withdrawal. Is there anyway to trick 
the II-Plus into running Appleli/orks? If so, then how 
about getting it to take advantage of a 128K Saturn 
card? 

What do you suggest is the best way of baching up 
the Sider in a fairly speedy and inexpensive way? 

QaiyWard 
Honolulu, Hawaii 

// you think Open-Apple is expen^m now, wait 
until I review Apple's $7,000 LaserWriter printer. Don 
Lancaster says it works better on a // running Apple 
Mter than on the Macintosh. 

Vm sorry about the dent in your wallet but I think 
you've made good choices. The ProDOS/^der/App^e- 
mrks/RANW08KS combination Is the most signifi- 
cant thing to happen in Ote Apple II worid ^nce the 
lie was introduced. Apple itself doesn't push this 
conpguration because parts of it compete with 
Apple's own present and future products. Few peo- 
ple relying on the advice of dealers or the general 
press will hear about it efther. /Yonethefess, If 
appears that thousands of experienced Apple users 
are putting together systems like this and finding 
themselves with more cotr^uier power than they 
ever dreamed of 

Checkmate Technology (509 South Rod^ford Dr 
Tfempe. AZ 85281 800-325-7547) makes a $550 80/ 
160-column card that allows you to run App/eWbrfcs 
on a U-Plus. I have not tried the card, but I am inclined 
to think that if your main goal is to run AppleWorks, 
your $550 would be better spent making a down- 
payment on another He or a lie. (You're right, this is 
an expensive neu^etter.) Il-Piuses are best used in 
non-keyboard/screen intensive tasks— making 
copies of disks, running printers, and so on. I think 
thefutureofthell-nusisasanetworkwntroaer, but 
the required hardware and software hasn't been 
developed yet that I know of. 

The Sider comes with a program for backing up 
the DOS 5.5, CP/M, and Pascal areas of the disk. 



Apple has a ProDOS program called Backup it, 
which I got a remew copy of sometime ago. It seems 
to work pretty well however, it is currently only 
auaiiahie by buying Apple's Profile hard disk. If Apple 
is smart they'll soon offer it separately, since few 
people are going to pay $1500 extra for a Profile just 
to get it. It would make a great $40 to $50 stand- 
alone package, however. 

Breaking the AppleWorks barrier 

I have been using the data-base module of Apple- 
Works for the past month and agree with your recent 
comments regarding its usefulness. Extra memory 
on a RAN card increases the size of the desktop^ but 
is there any way to increase the X350 limit on the 
number of records per data base file that AppleWorks 
will accept? 

Martin Kalman 

friday Harbor, Wash 

/ touched on the solution in last month's issue, but 
it's worth repeating— the current version of the soft- 
ware that comes with Applied Engineering's RAM- 
WORKS allows 4,285 records per file. 

Interrupts and the sun 

I'm working on a Basic program that uses a Thun- 
derclock and an analog-toiJigital conversion board 
to periodically measure temperatures and pump sta- 
tus in an open-loop solar collector system. Eventually 
I'd like to get it into machine language so that 1 can 
use interrupts to achieve foreground/background 
operation but tiiats a ways down the road. I'd like the 
display to be in 80 columns but seem to get in trouble 
whenever I read the dock or the a/d board. Is there a 
way to read anotiier slot and keep 80 columns with- 
out refreshing the saeen every time? I've been inter- 
ested in Apple's lie enhancement heicmse I've read 
they have finally fixed the byte $45 interrupt problem. 
This afternoon 1 read that ProIX)S supports inter- 
rupts on the regular lie. What gives? Do I need the 
enhancement or not? 

Bill Stiles 
Charleston, S.C. 

Jb return to the 80-column card without clearing 
the screen do this: 

DOS 3.3 

POKE 54,7 : POKE 55, 195 : CftLL 1002 
ProDOS 

PRINT CHR$(4);"PRaflSC307" 

See the January issue (page 8) if you wanttoknow 
how these tricks work. 

Let's go through interrupts from the top. An inter- 
rupt is an electronic signal from a peripheral that 
tells the 6502 microprocessor to immediately stop 
whatever it's doing and come to the aid of the 
peripheral 

A typical use for Interrupts would be with a high- 
speed modem. As each character is received, it is 
necessary for the computer to get it and store it 
m>meplace so that it isn't overwritten by the next 
character cominig in. If Interrupts aren't used, the 
modem software must continually poll the modem 
to find out ^a dmrdcter has been received yet With 
interrupts active, on the other hand, the modem 
stops ti\e software and yells "come and get It" when- 
ever a character is ready. 

Most clock cards can also be set up to send an 
interrupt every so ofien. Clock interrupts provide a 



way for your computer to check on a security sys- 
tem or a soiar collector every once in awhile (in the 
backgrourull white still being primarily used for 
something else (in the foreground). I too have a 
Thunderclock and although it has proven very reii- 
able (and expensive), its lowest interrupt rate is 64 
times a second— somewtiat more often than I've 
ever had any use for. 

Many computers have an interrupt-driven key- 
board. This is a good use for interrupts, although the 
Apple keyboard doesn't normally support this. Prod- 
ucts such as Apple Writer must take a peek at the 
keyboard about a hundred times a second, even 
while doing such things as scrolling the screen, to 
keep a fast typist's keystrokes from being lost How- 
ever, the Apple Mouse card (built into the /^ple lie) 
provides keyboard interrupts to the Apple II family if 
you really need them. 

The main idea of interrupts is that afier the inter- 
rupter's needs have been taken care of the 6502 can 
go back to whatever it was doing before. In order to 
do this successfully, however, the status of the 
microprocessor and of the computer's memory con- 
figuration at the time the interrupt occurred has to be 
saved somewhere. The 6502 automatically saves its 
status register and program counter on the stack 
when an interrupt occurs, but it's up to a machine's 
software to take care of everything else. After the 
6502 saves the status and program counter, it Jumps 
to whatever address is stored at memory location 
$FfTE, 

Interrupt support Is built into ail Appie Us. In the 
original U, ll-Pius, and He, the address stored at 
$Pm points to a routine in the Monitor that saves 
the contents of the 6502's A register at memory 
location $45 before passing control to the pro- 
grammer's interrupt handler. This would be great if 
no other software ever used $4B for anything. 
Software thatdoes use $45, however, fails with inter- 
rupts, because every time an interrupt occurs the 
contents of byte $45 are destroyed. 

The Apple II has a reputation of not working with 
interrupts because DOS 3.3 saves stuff in $45, You 
can work around this bug by disabling interrupts 
before giving a DOS command and enabling them 
agam afterwards (this requires assembly language 
trides. By the way, both DOS 15 and ProDOS disable 
interrupts while actually reading from or writing to a 
disk. This is because the subroutines that adually 
deal with the magnetic patterns on your disks are 
extremely time-sen^tive and don't work if inter- 
rupted, Consequentiy, intemq)ts are disabled and 
can remain that way for relatively long periods of 
time during disk access — several seconds if an error 
occurs that causes the disk to recalibrate itself.) 

On the enhanced lie and lie, Appte solved the 
interrupt problem by saving the A register on the 
6502's stack rather than at byte $45. Thus, you can 
successfully interrupt DOS 5.5-based programs on 
one of these machines. The enhanced lie and He also 
automatically save the memory configuration at the 
time of the interrupt, and put it back again when the 
interrupt handier is finished. 

ProDOS never uses $45. Consequentiy, itsiq>ports 
interrupts on any kind of Apple. It abo automah'ca/ij/ 
saves Ute registers, bytes $FA through $IT, and 16 
bytes of the stack. The Interrupt handler can freely 
use these resources, neither the Interrupt handier 
nor any ProDOS program, however, should ever use 
$45 or $7f^ (ProDOS uses $7F8 to store the number 
of the slot that was active when the interru[^ 
occurred.) 
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Dump 40 

! am looking for a method to dump just the 40- 
column screen to the printer. I tried modifying your 
80<olumn dump (February, page 15) by poking only 
the odd columns, but it did nasty things to my Apple- 
soft program. 

Richard Hanley 
Milford, Conn. 

You can turn februaqi's DUMP 80 into DUMP 40 
by simply deleting lines 330, 340, and 350. In 40- 
column mode, it isn't necessary to poke anything to 
read the screen memory correctly. (If you've 
updated your DVMF 80 with the modifications I 
gave in March (page 22) to make it run faster, youH 
also have to remove theL$^ from line 360.) 

Learning assembly language 

I'm interested in learning assembly language. 1 am 
at a beginners level programming in 5asic Could you 
recommend any sources? 

John J. Qwynn 
Roslindale, Mass. 

/ think the best book around for learning assembly 
language on the Apple is Roger Wagner's Assembly 
lines. Since this book was published by Softalk 
Books, many people are under the impression it is 
no longer available, and it wasn't there for awhile, 
fiowever, Mark Pelciarski of Penguin Software 
recently managed to wrestle down the rights to 
Softalk's books and is now distributing them. 

They 're still called Softalk Books and they can be 
ordered from Penguin Software, P.O. Box 311 Ge- 
neva, II 60134; orders 800-323-0^04, information 
312-232-1984. Apple-related books currently avail- 
able and prices (add $2 for shipping) are: 

Rpplesoft Isn't Hard 114.95 
by Doug Darlston 

Assembly Lines $14.95 
by Roger Wagner 

Graphically Speaking $14.95 
by Mark Pelczarsl<i 

Macintosh Complete! $14.95 
by Doug Glapp 

Apple He hardware fix 

Early Apple lies (serial numbers below D51000) 
have a hardware bug that can prevent them from 
working with 1200 baud modems and other high- 
speed peripherals. If you have a peripheral that won't 
work with your 11c, Apple dealers are supposed to 
replace the motherboard in your lie without charge. 

Jim Luther 
Kansas City, Mo. 

Super hi-res graphics 

Do you know of any way of increasing the Apple Il's 
resolution past 560 x 192? There was mention of a 
card in an old Softalk letter that had resolution capa- 
bilities of 640 X 768. It was made by Demco Electron- 
ics and called the Graphics Tool Kit Does this still 
exist? Where are these people? How come other 
companies don't make "add-ons" to increase 
resolution. 

I love my Apple and wouldn't trade it for all the IBMs 
in the world, but when it comes to information about 
graphics there is a curious lack of information. For 
example, no computer store in my area has any 



graphics tablet for me to try. They all say there is no 
demand for them so they can't afford to stock them. 
Not only that 50 per cent of the stores claim Apple 
doesn't make a graphic tablet anymore; what gives? 

Clyde Godfrey 
Ann Arbor, Mich. 

Demco Electronics (10516 Grevillea Ave, Ingle- 
wood, Calif. 90304, 213-677-0801} sells its Graphics 
Tool m for $595. It includes eight disk sides of 
software and sample data and a peripheral card that 
works in slots 1 through 7. It provides 640 x 384 
screen resolution (the Macintosh screen is 560 x 
354) and can print at 640 x 768. 

While finding out about these higher-resolution 
modes can be hard, there is something there to find 
out about I recently got a letter from a company 
called MicroGraphic Images (21040 Victory Blvd, 
Suite 210, Woodland hills, CA 91367 818-368-3482), 
which is justifiably proud of itself for having created 
a professional-quality high-resolution graphics 
workstation based on the Apple He. Their system has 
512 X 512 screen resolution with 16 colors and simul- 
taneously uses the Apple's 6052 and a 6 MHz Z-80 
card to increase the system's speed. The whole 
thing, including a He with drives, VidexUltratermand 
monodirome monitor for the ' command ' screen, 
graphics board and RGB monitor for the ''design" 
screen, Z-80 board, graphics tablet, software, 
detailed manual and heavy-duty power supply and 
cooling fan costs $8,795, which is about $20,000 
less than Uie systems it competes with. If you 
already have the hardware, the guts of the system 
(software mosUy) are available separately at a lower 
price. 

I called Diane Blake, Vice President of Creative 
Development at MicroGraphic Images, and asked 
her your question about obtaining information on 
super high-resolution graphics on the Apple II. She 
agrees with you that it's hard to obtain. She said it 
wouldn't actually be necessary to see a card before 
buying— what you need to ask about is the resolu- 
tion, number of colors, and kinds of graphic primi- 
tives built into the hardware. MicroGraphic Images 
uses the number nine Graphics Card, from a com- 
pany called tiumberfline (stupid me, I forgot to ask 
for their address; MicroGraphic Images will probably 
sell you one if you're interested, though). 

One thing to consider is that when you deal with 
super high-resolution, you have to move a lot more 
bytes around to fill a picture. Thus, super high- 
resolution systems on the Apple II may be slow 
unless you also add a faster 6502 or some other 
chip, as MicroGraphic Images does. And unless you 
are an assembly language programmer willing to 
devote all your time to graphics, the software that 
comes with any card you buy will be very important 
to your ultimate satisfaction. 

Regarding Apple's Graphic Tablet Blake agrees 
with you that it is hard to obtain but she says it is still 
being made. (A call to Apple confirmed this. The 
suggested retail price is $795.) Dealers are mvced up 
because Apple pulled it off the market for about a 
^ear sometime ago because of radio-interference 
problems that have since been solved. Blake said 
MiaoGraphic Images became an Apple VAR (Value- 
Added Reseller; this means they buy direct ft-om 
Apple rather than through dealers) primarily to have 
better access to the tablets. Blake also mentioned 
that there are RS'232 graphics tablets available from 
other manufacturers; these would work with an 
Apple II if you had a serial card. 

Blake says most of MicroGraphic Images' poten- 



tial customers are surprised to find such a high- 
powered system runningon an Apple II. Most of their 
competitors use IBM-PCs. 'The quality, reliability, 
and open architecture of the Apple II is the tie that 
binds this system together On any other machine it 
would be slower, more expensive, and less reliable." 

California-area subscribers interested in just how 
far the little Apple II can be pushed, as far as graphics 
are concerned anyhow, can see MicroGraphic 
Images' stuff at the West Coast national Computer 
Graphics Association conference in Los Angeles, 
June 25-27 

HCOLOR me invisible 

I recently encountered a hi-res graphics program 
thatworked well on an Apple Il-Plus but didn't work at 
ail on a lie. After some fiddling around, 1 discovered 
the problem had to do with the default HCOLOR on 
power up. When the ll-Flus powers up, HCOLOR 
defaults to 7 (white); when the He powers up, HCOLOR 
defaults to (black). This can be seen by examining 
byte 228 ($E4). 

Thus programs that fail to specify an HCOLOR will 
fail to work on the lie, even though they (accidentally) 
work just fine on the Il-Plus. 

now a question, normally an Apple peripheral card 
can be identified by peeking its slot location. For 
example, to verify that a disk controller card is in slot 
6, all one needs to do is PEEK the locations starting at 
50688 ($C600). For the Apple Disk II interi^ace, bytes 
50688 through 90 always contain 162, 32, and 160. 

However, this trick doesn't work for an Integer 
Basic ROM card or a Microsoft Softcard. The values 
peeked don't remain constant over time. The same 
thing happens with empty slots. How come? 

Michael Ching 
Honolulu, Hawaii 

Thanks for your HCOLOR tip. For the record, the 
meaning of the values youll find by peeking at byte 
228 ($E4) are: 0=black.l; 42=green; 85=violet; 
U7=white.l; U8=black.2; 170=orange; 21^blue; 
255^white.2. 

Slots 1 through 7 in all Apple lis each have an 
exxAusive 256-byte address range for machine lan- 
guage programs. A program that appears in this 
range is really on a ROM chip that's on a peripheral 
card. The program will appear within its slot's 
assigned address range when the card is plugged 
into the slot. 

The address range for each slot is $CsOO to $CsPP, 
where "s" is the slot number. The address range from 
$C800 through $Crrrcan also be used by machine 
language programs on peripheral cards, however, 
only one card at a time can use this space. Whenever 
a reference is made to byte $CFrr, all peripheral 
cards are supposed to turn their $C800-$CPPr 
memory oft. Whenever a reference is made inside a 
card's 25&byte program area, that card is supposed 
to turn its $C800-$Crrr memory on. This feature has 
been built into the Apple II since the beginning, and 
was the first use of ^bank switching" on the Apple. 

The system is ingenious. Most computers have to 
be "reconfigured" whenever a new peripheral is 
added or removed. This means the operating system 
must be modified by adding or removing machiiK 
language ' drivers ' that interact with the peripheraL 
But with the Apple II, this reconfiguration takes plaoe 
automatically when a card is inserted or remooect 
since the required machine language programs arc 
built into the peripheral cards. Steoe Hbzraafcaedits 
his friend Alan Baum with cormng up idOt this 
scheme (Byte, December 1984, page ATI). 
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However, some cards don't take advantage of it 
They have no machine language drivers built into 
the 256-byte program space. Since there's noUiing 
there, you'll get a different number everytime you 
FEEt{ at those addresses, just as you do if the slot is 
empty. 

Printers to flash 

I have developed a revolutionary new product that 
your readers might be interested in— a printer that 
will print flashing characters. I've been working day 
and night (yesterday and maybe tonight) on this 
project First I tried octopus ink, but ASCII printed as 
octal. I diluted it 4:1 and got binary. 

finally I got a bright idea and tried ink made from 
the juice of Canadian fireflies. 

Murray MacKenzie 
Scarborough, Ontario 

Readers may address inquiries to MacKenzie in 
care of the northern Lights. 

The wonderful worid of windows 

Type in and run the following Applesoft program: 

10 TEXT : HOnE : FDR 1=1 ID 23 : PRINT I : NEXT 
28 POKE 32,3 : HOME : END 

Why does HOME clear the lower 16 lines of the area 
outside (to the left of) the new text window and not the 
upper eight? 

Dennis Doms 
Kansas City, Mo. 

Let's begin by explaining a little bit about iwm- 
dows on the Apple 11 to everyone. The Apple II 
operating system has always provided pro- 
grammers the ability to specify a ' text window" for 
all further PWfiTing to appear in. Usually this win- 
dow is set to full-screen— 24 lines high by either 40 
or 80 columns wide. But a few simple FOKEs can 
make the window smaller and put it anywhere on 
the screen. The followingtabie shows which bytes to 

mm: 



up windows using an integer array (variable name 
ends with a to hold the dimensions of several 
different windows. It will show you some of the 
possibilities windows provide: 

10 REM *** WINDOW DEMO *«» 
100 NORMAL : TEXT : HOHE 

110 5W=40 : REM determine screen uidth (40 Of BW] 
120 IF PEEI<(G443S]=G AND PEEK ( 49163 )>12? THEN SW=B0 
130 NW=S : REM number of uindous used 
140 DIM W3i(NW,4) : REM integer array for windows 

150 FDR W=l TO NW : REM get and check dimensions 
1G0 : READ WS!(W,1) : REM left edge 
170 : READ WS(W,2) : REM width 
180 : READ W3!(W,3) : REM top 
190 : READ Wa(W,4) : REM bottom 

210 : IF W^(W,1)<1 OR W*(W,1)>5W THEN 

PRINT "LEFT EDGE OFF SCREEN IN WINDOW ";i4 
220 : IF W5S(W,i]+W^{W,2) > SN+1 THEN 

PRINT "RIGHT EDGE OFF SCREEN IN WINDOW ";W 
230 : IF W!iS(W,3)<l OR W^(W,3)>24 THEN 

PRINT "TOP EDGE DFF SCREEN IN WINDOW ";t4 
240 : IF WSi(W,4]<l OR WJ(W,4)>24 THEN 

PRINT "BOTTDN EDGE DFF SCREEN IN WIMDOW ";W 
250 : IF W^(W,2)<1 THEN 

PRINT "WIDTH NEGATIVE IN UINDOW U 
2G0 : IF WSt(W,3) > WS:(W,4) THEN 

PRINT "TOP 8ELDW BOTTOM IN WINODW ";W 

270 NEXT 

280 PRINT : PRINT 

290 INPUT "PRESS <RETURN> TO BEGIN"; W$ 
300 REM LEFT WDTH TOP Bill 



310 DfiTA 
320 DATA 
330 DATA 
340 DATA 
350 DATA 
360 DATA 
370 DATA 
3B0 DATA 
390 DATA 



1» 
20, 

1, 
20, 

1. 

1, 
20, 
20, 



20, 1, 12 

20, 1, 12 

20, 13, 24 

20, 13, 24 

40, IB, 24 

40, IB, IS 

1, 1, 24 

5, 12, 12 

82, 25, 



500 INVERSE : HOHE 

510 INPUT "WINDOW tl?";WI 

520 NORMAL : TEXT : HOME 



byte 


use 


aliDuable 


range 


530 W=VAL[W$) : IF W<1 OR W>NW THEN END 






40-cal 


80 -CD I 


540 POKE 32,U:fe(W,l)-l : POKE 33,W3f(U,2) : 


32 {J20) 


left edge 


0-39 


0-79 


POKE 34,w;fe(W,3)-l : POKE 35,W^(W,4) 


33 (521) 


width 


1-40 


1-B0 


550 VTAB WS;(W,3) : HTAB W^(W,1) : 


34 ($221 


top 


0-23 


0-23 


REM put cursor inside new window 


35 (J23) 


bottom 


1-24 


1-24 


560 GOTO 500 



The following program demonstrates a way to set 
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lines 100 to 590 initialize the program. For things 
to work right we need to know whether a 40-column 
or an 80-column screen is active, line 110 assumes 
40<olumns: line 220 changes this to 80 if byte 
64435 indicates the program is running on a lie or 
llcAFID if byte 49183 indicates 80'Column mode is 
active. 

Line 150 sets up a loop for reading the window 
dimensions from the DATA statements in lines 300 to 
390. Unes 210 to 260 check these dimensions to 
make sure they are allowable and sends messages 
to the screen when mistakes are found. Frogram 
initialization ends in line 290. 

The main body of the program is at lines 500 to 
560. Line 510 asks which window you want to acti- 
vate. When you run the program, enter a number 
between 1 and 8 in response to this question. Enter- 
ing 9 will crash the program because the dimensions 
for window 9 are bad. Anything else EfiDs the 
program. 

Line 540 pokes bytes 32-35 with the dimensions 
for the chosen window. It also makes some adust- 



ments to the dimensions (by means of the -1 in POKE 
32 and FOKE 34) so they're easier for us humans. 
These adjustments allow you to specify window 
dimensions using the same screen coordinates as 
VTAB and flTAB, In other words, the acfjustments 
allow you consider the top line and the left-most 
column as number I rather than 0. 

Line 550 puts the cursor inside the specified win- 
dow Une 560 loops bacic to line 500, where the 
program continues. If you are using a He or lie with 
the 80-column firmware active, Une 500 will cause 
the window to appear as an inverse rectangle on 
your screen. On a Il-Flus, or with the 80-column 
firmware off, you will have to search for the edges of 
the window by pressing Escape and moving the 
cursor around with the I-J-K-N keys. Alternatively, 
you could replace line 500 with this: 

500 INVERSE : FDR 1=1 TD 24 : PRINT SPC(SW) : NEXT 

Its not elegant, but it will make your window 
clearly visible. 

If the wmoow DEMO gets your interest up, try 
GIRAFFE, however, I warn you that it has no redeem- 
ing social value whatsoever: 

10 REM «»« GIRAFFE *«» 
100 NORMAL : TEXT : HOME 

110 5W=40 ; REM determine screen width (40 or 80?) 
120 IF PEEK(G4435)=G AND PEEK ( 49183 )>127 THEN SW=B0 
130 POKE 33,1 : REM make uindow 1 column uide 

200 INPUT "]";X$ 

210 HOME : PRINT CHRS(7];"]I FEEL ILL." 
220 C=PEEK(32) 
230 E-€*2 

240 IF C=>SW THEN TEXT : HOME : POKE 33,1 : C=0 
250 POKE 32, C 
260 VTAB 1 
270 GOTO 200 

This program uses the TEXT command a couple of 
times. TEXT always opens the window to the full 
screen size (as well as turning off graphics, which is 
meaningless here). Pressing the Reset key also 
opens the screen window to full size. If you use 
windows in your programs, remember ttiat your 
reset trap, if you have one (see the February issue, 
page 16), will have to fix things up. 

Window bugs result from a number of mistakes, 
but the two most common are making a window 
wider than the screen itself and forgetting to put the 
cursor inside the window. The Apple's screen display 
routines do not check the contents of bytes 32-35 to 
see if they make sense. If you put in nonsense you 
don't get an error message — you get erratic opera- 
tion. This includes the possibttUy of destroying 
your program. 

The 80'Column firmware in the original He has 
some of its own window bugs. To avoid them, put the 
left edge of all windows in an odd column (assuming 
you call the first column I not 0). 

How that the preliminaries are out of the way, lets 
answer the original question. POt^E 32,3 moves the 
left edge of the lext window" to the fourth column 
on the screen. The problem here is that byte 33, the 
screen width, still holds 40 (or 80), thus right edge of 
the window is in column 43 (83). This is off the 
screen, but the screen display routines don't check 
for that Thus, the HOME command starts messing 
with bytes it's not supposed to touch. 

This time the bug is in the program, not in the 
Apple. To get the program to work correctly, change 
line 20 to: 

20 POKE 32,3 : POKE 33,40-3 : HOME : END 



